home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / unix / xf86read.zip / README.LIN < prev    next >
Text File  |  1994-07-26  |  8KB  |  168 lines
  1.              Information for Linux Users
  2.              ---------------------------
  3.  
  4. Contents
  5. ----------
  6.     1) Linux versions on which XFree86 has been tested
  7.     2) Running XFree86
  8.     3) Backwards Compatibility
  9.     4) Compiling XFree86
  10.     5) Compiling a PEX server
  11.     6) Omissions
  12.  
  13. 1 - Linux versions on which XFree86 has been tested
  14. ---------------------------------------------------
  15.     XFree86 has been tested with Linux version 0.99pl15. It should work
  16. with any later version without change. The binaries and libraries are based
  17. on the 4.5.21 DLL C libraries. The DLL X libraries are produced with the 2.10
  18. dll-tools by Eric Youngdale.
  19.  
  20.  
  21. 2 - Running XFree86
  22. -------------------
  23.     XFree86 is installed in /usr/X386. It requires about 4mb of virtual
  24. memory to run, although having 8mb of RAM is probably the minimum comfortable
  25. configuration. A 387 coprocessor is helpful for 386 machines, although
  26. greater gains in interactive performance are obtained with an increase in
  27. physical memory. Also, a faster graphics card, bus or RAM, will improve
  28. server performance.
  29.  
  30.     After unpacking the tar files, you need to include /usr/X386/lib
  31. in /etc/ld.so.conf (where it should already be by default) or in your
  32. LD_LIBRARY_PATH environment variable. Also, the configuration file
  33. /usr/X386/lib/X11/Xconfig *MUST* be properly filled out based on the host
  34. setup using Xconfig.sample as a starting point and README.Config as
  35. guideline.  You may damage your hardware if you use a wrong Xconfig file,
  36. so READ THE DOCS, especially the man pages and the other README files in
  37. /usr/X386/lib/X11/etc.
  38.  
  39.  
  40.     XFree86 has the ability to perform VT switching to and from the X
  41. server. When first started, XFree86 will automatically locate the first
  42. available VT (one that hasn't been opened by any process), and run on that
  43. VT.  If there isn't one available, XFree86 will terminate with an error
  44. message.  The server can be run on a specific VT by using the "vt<nn>"
  45. option, where <nn> is the number of an available VT (starting from 1). If
  46. you don't have a free VT XFree86 cannot run. You can increase the number
  47. of available VTs by increasing the value of NR_CONSOLES in
  48. include/linux/tty.h and recompiling the kernel.
  49.  
  50.     Once running inside X, switching to another VT is accomplished by
  51. pressing Ctrl-Alt-<Fnn> where nn is the number of the VT to switch to. To
  52. return to the server, press the proper key-combination that moves you back
  53. to the VT that XFree86 is using: by default, this is Alt-<Fmm>, where mm
  54. is the number of the VT the server is running on (this number is printed
  55. when the server is started).  Note that this is NOT the VT from which the
  56. server was started.
  57.  
  58. NOTE: you can redefine the text-mode keybindings with the 'loadkeys'
  59. command found in the kbd-0.81.tar.gz archive (or a later version thereof).
  60. With this, you can (for example) make Ctrl-Alt-<Fmm> work from text mode
  61. the same way it works under the XFree86 server.
  62.  
  63.      The XFree86 server now queries the kernel to obtain the key
  64. binding in effect at startup. These bindings are either the default map in
  65. place when the kernel was compiled, or reloaded using the 'loadkeys'
  66. utility. Not all keys are bound; special kernel-specific, multiple keysym,
  67. dead keys are not handled by the server. All others are translated to
  68. their X equivalents. Note that the XFree86 server only allows for four
  69. modifier maps: unshifted, shifted, modeswitch unshifted and modeswitch
  70. shifted.  Depending on what the modeswitch key is (it is settable in your
  71. Xconfig and defaults to Alt), XFree86 will read those tables into its
  72. keymaps.  This means if you use certain keys, like left-Control, for Linux
  73. modeswitch, that will not be mappable to X. Read the manpage XFree86kbd
  74. for more information about X keyboard handling.
  75.  
  76.  
  77.     When the server is exited, it will return to the original VT it
  78. was started from, unless it dies unexpectedly, when the switch must be
  79. done manually. There still seem to be weird combinations of graphic cards
  80. and motherboards that have problems to restore the textfont when returning
  81. from XFree86 to the text mode. In these cases using the runx script from
  82. the svgalib distribution might help.
  83.  
  84.     There are some quirks that may need some fixing depending on your
  85. configuration. In the past, Linux xload used the BSD method of obtaining
  86. the load average from the running kernel. In the XFree86-1.3 release, that
  87. has been replaced by reading the information from /proc/loadavg instead,
  88. which should be forward-compatible with future kernel releases. Xman has
  89. also been changed to support the GNU groff family instead of the BSD nroff
  90. family. A quick edit and recompile restores BSD conventions. The server
  91. has been modified to provide better console redirection support for
  92. clients, which includes changing the ownership of /dev/console and
  93. /dev/tty0 as well as the VT used to run on. Unfortunately, the kernel
  94. requires that a process be setuid root to perform console redirection, so
  95. xterm and xconsole must be setuid root.  As xconsole is not designed with
  96. running setuid root in mind, this opens a big security problem.
  97.  
  98. 3 - Backwards Compatibility
  99. ---------------------------
  100.  
  101.     Old binaries (linked to XFree86-1.2, XFree86-1.3 or XFree86-2.0
  102. libraries) will continue to work, but may need an explicit symlink from
  103. /lib/libX{11,t,aw}.so.3 to /usr/X386/lib/libX{11,t,aw}.so.3.  Linking with
  104. ld.so against the XView3L5 distribution will give problems with pre-1.3
  105. versions of ld.so, since the XView libraries contain the absolute path to
  106. the shared images, which is discouraged with ld.so. A temporary fix is
  107. including / in /etc/ld.so.config, better recompile XView with relative
  108. library names or get a newer ld.so.
  109.  
  110. 4 - Compiling XFree86
  111. ---------------------
  112.     There are no special instructions required for compiling XFree86.
  113. This version was compiled with gcc-2.5.8, the 4.4.21 DLL libraries and the
  114. 1.4 shared, dynamic linker ld.so. The tools-2.10 DLL package was used to
  115. generate the shared libraries. The server has been compiled with -m486,
  116. which optimizes it for the 486 processor, but the binary will run on the
  117. 386 processor (there is a slight increase in binary size over using -m386,
  118. but no loss of performance).
  119.  
  120.     The distribution is very large, but it is possible to compile
  121. XFree86 on a single 64mb partition, if the source tree is carefully
  122. trimmed (no manpages, PEX or large clients). Simply run "make Makefiles"
  123. to create the Makefiles, then stop the make and run each piece
  124. individually. It is not necessary to run "make depend" as well, which
  125. saves some space.  Having 100mb available makes compiling XFree86 a lot
  126. easier. You will need about 10mb of virtual memory to compile the entire
  127. server.
  128.  
  129.     There is support now for creating X DLL libraries. By default,
  130. certain libraries are compiled into both static and shared form, but this
  131. can be changed by editing mit/config/lnuxLib.rules. The new shared library
  132. symlinks no longer need to be moved to /lib, as starting with XFree86-2.0
  133. the shared, dynamic linker ld.so is used.
  134.  
  135.     If patches are applied which change the libraries, modified
  136. jump_xxx files will be needed. Those can be generated according to
  137. instructions given in the dll tools package, and will be made available as
  138. XFree86 patches. The file mit/config/lnuxLib.rules contains detailed
  139. instructions about defining the JUMP_xxx variables for compiling an
  140. external X shared lib using the X shared libs.
  141.  
  142.     Thanks to Dirk Hohndel (hohndel@informatik.uni-wuerzburg.de) for
  143. working out all the details and doing all the work in creating the first
  144. set of XFree86 DLL libs, on which the current method (developed by Orest
  145. Zborowski (orestz@microsoft.com)) is based.
  146.  
  147. 5 - Compiling a PEX server
  148. --------------------------
  149.  
  150.     PEX is now a part of the XFree86 source distribution and including
  151. it in the server is trivial. First, edit mit/config/site.def and change
  152. BuildPex from NO to YES, then perform a make World. The server, libraries
  153. and demos will all get built with PEX support. After installation, the
  154. new server can be verified by using xdpyinfo, which should show X3D-PEX
  155. as an available extension. Alternatively you can use the LinkKit to
  156. produce a server including PEX. See the relevant docs in
  157. /usr/X386/lib/Server/README.
  158.  
  159. 6 - Omissions
  160. -------------
  161.  
  162.     With each release there are fewer omissions from the basic X11R5
  163. offering. Starting with XFree86-2.0 the MITSHM (shared memory) extensions
  164. are included. Now only the XINPUT extension is missing.
  165.  
  166.  
  167. $XFree86: mit/server/ddx/x386/README.Linux,v 2.7 1994/03/08 08:31:17 dawes Exp $
  168.